NOM¶

readv, writev - Lire ou écrire dans plusieurs tampons

SYNOPSIS¶

#include <sys/uio.h>

ssize_t readv(int fd, const struct iovec *iov, int iovcnt);

ssize_t writev(int fd, const struct iovec *iov, int iovcnt);

DESCRIPTION¶

La fonction readv() lit iovcnt blocs depuis le descripteur de fichier fd dans les multiples tampons décrits par iov.

La fonction writev() écrit au plus iovcnt blocs décrits par iov dans le fichier associé au descripteur fd.

Le pointeur iov pointe vers un tableau de structures iovec définies dans <sys/uio.h> :

struct iovec {


    void  *iov_base;    /* Adresse de début */


    size_t iov_len;     /* Nombre d'octets à transférer */
};

La fonction readv() travaille comme read(2) sauf que plusieurs tampons sont remplis.

La fonction writev() travaille comme write(2) sauf que plusieurs tampons sont écrits.

Les tampons sont considérés dans l'ordre du tableau. Cela signifie que readv() remplit iov[0] complètement avant d'en arriver à iov[1], et ainsi de suite. (S'il n'y a pas assez de données, tous les tampons pointés par iov ne seront pas forcément remplis.) De même, writev() écrit tout le contenu de iov[0] avant de considérer iov[1], et ainsi de suite.

Les transferts de données effectués par readv() et writev() sont atomiques : les données écrites par writev() sont écrites d'un bloc qui n'est pas interrompu par des écritures venant d'autres processus (mais voir pipe(7) pour une exception) ; de façon similaire, readv() a la garantie de lire un bloc contigu de données depuis le fichier, quelles que soient les opérations de lecture effectuées par d'autres threads ou processus qui ont des descripteurs de fichier correspondant à la même description de fichier ouvert (voir open(2)).

VALEUR RENVOYÉE¶

S'ils réussissent readv() renvoie le nombre d'octets lus et writev renvoie le nombre d'octets écrits. En cas d'échec -1 est renvoyé, et errno contient le code d'erreur.

ERREURS¶

Les erreurs indiquées pour read(2) et write(2) sont susceptibles de se produire. De plus, il peut survenir :

EINVAL

La somme des valeurs iov_len déborde du type ssize_t, ou le nombre iovcnt de vecteur est nul ou supérieur au maximum autorisé.

CONFORMITɶ

BSD 4.4 (les fonctions readv() et writev() sont apparues dans BSD4.2), POSIX.1-2001. La libc5 de Linux utilisait le type size_t pour le paramètre iovcnt et int en retour de ces fonctions.

NOTES¶

BOGUES¶

Il est déconseillé de mélanger les appels readv() ou writev() qui agissent sur les descripteurs avec les fonctions de la bibliothèque stdio ; les résultats sont indéfinis et probablement différents de ce que l'on attend.

EXEMPLE¶

Le segment de code suivant donne un exemple d'utilisation de writev() :

char *str0 = "hello ";
char *str1 = "world\n";
struct iovec iov[2];
ssize_t nwritten;
iov[0].iov_base = str0;
iov[0].iov_len = strlen(str0);
iov[1].iov_base = str1;
iov[1].iov_len = strlen(str1);
nwritten = writev(STDOUT_FILENO, iov, 2);

VOIR AUSSI¶

read(2), write(2)

COLOPHON¶

Cette page fait partie de la publication 3.23 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION¶

Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <URL:http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <URL:http://alioth.debian.org/projects/perkamon/>.

Christophe Blaess <URL:http://www.blaess.fr/christophe/> (1996-2003), Alain Portal <URL:http://manpagesfr.free.fr/> (2003-2006). Julien Cristau et l'équipe francophone de traduction de Debian (2006-2009).

Veuillez signaler toute erreur de traduction en écrivant à <perkamon-l10n-fr@lists.alioth.debian.org>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».